home *** CD-ROM | disk | FTP | other *** search
/ Ultimedia 1 / Ultimedia 1.iso / tools / grafiktools / aive / aive.doce < prev    next >
Encoding:
Text File  |  1994-03-14  |  5.6 KB  |  165 lines
  1.                            Amiga Image ViewEr
  2.                               version 1.5
  3.                                March 1994
  4.  
  5. Role : Displaying 256 colors pictures on a basic Amiga .
  6. ------
  7.  
  8. Copyright :
  9. -----------
  10.    AIVE is (c) 1994 Laurent Vivier . It may not be sold in commercial goal
  11. without my written approval . It can't be distributed for a fee which exceed
  12. of 15 French Francs (3 dollars) . It is forbidden to make a profit through
  13. the distribution of this software without my written approval .
  14.    It can't be distributed without its documentations . Thus, Files "AIVE",
  15. "AIVE.docF", "AIVE.docE" can't be split .
  16.  
  17.    This software is freeware . You can contact me for help or any question,
  18. suggestions . (or to correct this document, to speak english is a nightmare
  19. for me)
  20.  
  21. Disclaimer :
  22. ------------
  23.  
  24.    I accept no responsability for the use or misuse of this software, and
  25. for dammage it could produce. Use at your own risks .
  26.  
  27. Contact :
  28. ---------
  29.  
  30.    postal address :
  31.  
  32.             Laurent Vivier
  33.             Avenue Général De Gaulle
  34.             38380 Saint Laurent du Pont
  35.             FRANCE
  36.  
  37.    e-mail :
  38.          Laurent.Vivier@ufrima.imag.fr (until june 1994)
  39.          vivier@isis.imag.fr (until june 1994)
  40.  
  41. Supported formats : GIF87a, GIF89a (interlaced or not), IFF .
  42. -------------------
  43.  
  44. The Graphic Interchange Format(c) is the Copyright property of
  45. CompuServe Incorporated. GIF(sm) is a Service Mark property of
  46. CompuServe Incorporated.
  47.  
  48. Use :
  49. -----
  50.  
  51.    We can use AIVE only from CLI (or Shell) . We give file name and options
  52. from parameters command line .
  53.  
  54. Supported options :
  55. -------------------
  56.  
  57.    AIVE writes possible options if we run it without parameters !
  58. All parameters must be written in lower case .
  59.  
  60. AIVE name [hire|lore|ehb][nolace][grey][scale]
  61.           [width w][heighth][ratio a/b][color #colors]
  62.  
  63. HIRE,LORE,EHB : to choose graphic mode to use
  64.    HIRE : high resolution
  65.    LORE : low resolution
  66.    EHB  : Extra-Half-Bright
  67. the default mode is HAM .
  68.  
  69. NOLACE : by default it uses interlaced mode, this option disables it .
  70.  
  71. GREY : to display picture in grey levels (16 colors, HIRE)
  72.  
  73. COLOR n : n is the number of colors tu use (>= 8, default is the maximum).
  74.           With the option GREY, n is the number of grey levels .
  75.  
  76. SCALE   : the size of the picture is modified to fit in the screen .
  77.  
  78. WIDTH w : w is the maximum width of the screen
  79.  
  80. HEIGHT h : h is the maximum height of the screen
  81.  
  82. RATIO a/b : bending ratio of the screen : x is the width of a pixel, y the
  83.             height, then : y = x * (a/b) .
  84.             default : a/b = 1/2 LORE (= HAM, EHB)
  85.                           = 1/1 LORE and NOLACE
  86.                           = 1/1 HIRE
  87.                           = 2/1 HIRE and NOLACE
  88.             that values are not best . But they are dependant on your
  89.             screen . Compute them .
  90.  
  91. Interface :
  92. -----------
  93.  
  94.    When we run AIVE, a window is opened . We find in the name of the
  95. picture, its kind (GIF87a, GIF89a, IFF ...), its size, and the progression
  96. of the decoding . A gadget "Stop" permits us to stop the operation, and to
  97. quit the program . The keyboard shortcut is "ESC", it's enable only if the
  98. window is activated (and then, not the screen where is the picture !) .
  99.  
  100. Note : Under OS2.0, you can display picture bigger than your screen . To
  101. move it use the standard system operation : Left Amiga - Left Mouse Key and
  102. move mouse to move picture . Under OS1.3, picture is automaticaly fitted
  103. in the screen .
  104.  
  105. Technical :
  106. -----------
  107.  
  108.    AIVE uses Floyd-Steinberg dithering, CIE luminance weight, and custom
  109. algorithms, and no floating point operations . For more details, refer to
  110. "AIVE.docF" (it's time to learn French ! All my apologies)
  111.  
  112. Possible evolutions :
  113. ---------------------
  114.  
  115.    - to run from Workbench
  116.    - gamma correction (why ?)
  117.    - a printer option
  118.    - a save option
  119.    - PCX and BMP formats, perhaps JPEG (I don't think !)
  120.    - a better human-computer interface under intuition
  121.  
  122. Compatibility :
  123. ---------------
  124.    AIVE was developed under OS1.2, then OS2.0 . It may be run under all
  125. systems .
  126.    We can meet problem with graphic cards : I don't use the "WritePixel"
  127. function from "graphics.library", but I write the value in memory .
  128.  
  129.    The test activity was made on my A500 :
  130.    mother board rev 5a, OS2.0, 2 drives DDDS, 512 FAST, 512 CHIP .
  131.  
  132. Thanks to :
  133. -----------
  134.  
  135.    Frederic Elisei   Archimede user of genius, who inspires me
  136.    Franck Lyonnet    Idem
  137.                      Look at their JPEG viewers for Acorn Archimede 5000,
  138.                      speedy than all GIF viewer on Amiga (500 !) .
  139.    Roger Wilson      who written a paper on his software ChangeFSI .
  140.    Steven A. Bennet  author of GIF decoder which inspirates me .
  141.    Cindy Crowford    to her beautiful body (a good motivation !) .
  142.  
  143.    UFR Informatique  where I have discovered the internet world .
  144.    et mathematiques  (Thanks to system administrators)
  145.    appliquees de     Come studying in Grenoble
  146.    Grenoble          (the country is beautiful : its ski resorts, its lakes)
  147.  
  148. History
  149. -------
  150. January 1994   version 1.0    First release
  151. January 1994   version 1.2    corrects 2 little bugs :
  152.                               - System alert with an odd picture width
  153.                               - little dithering saturation
  154. March 1994     version 1.5    Corrects other bugs :
  155.                               - system alert when using grey and low
  156.                                 resolution at the same time
  157.                               - impossibility to made grey levels with less
  158.                                 than 16 levels .
  159.                               Evolution :
  160.                               - Optimizing of dithering (close to 2 or 3)
  161.                               - scaling
  162.  
  163. Author : Laurent Vivier
  164. --------
  165.